Doc additions

svn path=/trunk/; revision=22010

diff --git a/ChangeLog b/ChangeLog
index 813380b9c95704d59c1c9aa75014c743e6cbc5a0..5eb797dccbec92bb645d9cd98cead12528162a04 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,6 @@
 2008-12-30  Matthias Clasen  <mclasen@redhat.com>
 
+       * gtk/gtkmenutooltbutton.c:
        * gtk/gtkprintoperationpreview.c: Doc additions
 
 2008-12-29  Matthias Clasen  <mclasen@redhat.com>

diff --git a/gtk/gtkmenutoolbutton.c b/gtk/gtkmenutoolbutton.c
index f1443c5d984fa57e2a7db6373b438ba923b003f7..bc6e5cb6a893c0169e6bf549f4f6a0bad42d124d 100644 (file)
--- a/gtk/gtkmenutoolbutton.c
+++ b/gtk/gtkmenutoolbutton.c
@@ -217,6 +217,19 @@ gtk_menu_tool_button_class_init (GtkMenuToolButtonClass *klass)
   widget_class->state_changed = gtk_menu_tool_button_state_changed;
   toolitem_class->toolbar_reconfigured = gtk_menu_tool_button_toolbar_reconfigured;
 
+  /**
+   * GtkMenuToolButton::show-menu:
+   * @button: the object on which the signal is emitted
+   *
+   * The ::show-menu signal is emitted before the menu is shown.
+   *
+   * It can be used to populate the menu on demand, using 
+   * gtk_menu_tool_button_get_menu(). 
+
+   * Note that even if you populate the menu dynamically in this way, 
+   * you must set an empty menu on the #GtkMenuToolButton beforehand,
+   * since the arrow is made insensitive if the menu is not set.
+   */
   signals[SHOW_MENU] =
     g_signal_new (I_("show-menu"),
                   G_OBJECT_CLASS_TYPE (klass),